
 
 F u n c t i o n :   t o N o d e ( s t r i n g M a r k u p ,   b o o l O n l y R e t u r n N o d e ,   b o o l O n l y R e t u r n A r r a y ) 
 
 
 
 D e s c r i p t i o n :   C o n v e r t s   a   m a r k u p   s t r i n g   i n t o   a   D O M   f r a g m e n t ,   e l e m e n t   n o d e ,   o r   e l e m e n t   n o d e   a r r a y . 
 
 
 
 R e t u r n s :   d o m F r a g m e n t ,   d o m E l e m e n t ,   d o m E l e m e n t A r r a y ,   o r   $ A   o b j e c t   i f   c h a i n e d . 
 
 
 
 N o t e :   T h e   t o N o d e ( )   f u n c t i o n   w i l l   r e t u r n   a   d o c u m e n t   f r a g m e n t   b y   d e f a u l t   w h e n   m u l t i p l e   e l e m e n t s   a r e   i n c l u d e d   a t   t h e   s a m e   l o g i c a l   l e v e l .   O t h e r w i s e ,   a   s t a n d a r d   D O M   n o d e   w i l l   b e   r e t u r n e d .   W h e n   b o o l O n l y R e t u r n N o d e   i s   s e t   t o   t r u e ,   a   s t a n d a r d   D O M   n o d e   o r   d o c u m e n t   f r a g m e n t   w i l l   a l w a y s   b e   r e t u r n e d   w h e n   p a s s i n g   a n   a r r a y   o f   D O M   n o d e s   i n t o   t h e   f i r s t   p a r a m e t e r .   W h e n   b o o l O n l y R e t u r n A r r a y   i s   s e t   t o   t r u e ,   a n   a r r a y   w i l l   a l w a y s   b e   r e t u r n e d   i n s t e a d . 
 
 
 
 I f   t o N o d e ( )   i n c l u d e s   n o   a r g u m e n t s ,   t h e n   a n   e m p t y   d o c u m e n t   f r a g m e n t   e l e m e n t   i s   r e t u r n e d . 
 
 
 
 E x a m p l e : 
 
 
 
 / /   C r e a t e   a n   e m p t y   d o c u m e n t   f r a g m e n t . 
 
 v a r   m y F r a g m e n t   =   $ A . t o N o d e ( ) ; 
 
 
 
 / /   C r e a t e   a   d o c u m e n t   f r a g m e n t   w i t h   m u l t i p l e   e l e m e n t s   a t   t h e   s a m e   l e v e l . 
 
 v a r   m y E l e m e n t   =   $ A . t o N o d e ( ' < i > T h i s   i s   a   t e s t . < / i > < b r   / > < i > S o ,   t r y   t o   l o o k   i m p r e s s e d . < / i > < b r   / > < i > H e y ,   t h a t   r h y m e d ! < / i > ' ) ; 
 
 
 
 / /   R e t u r n   a n   a r r a y   o f   a l l   m a t c h i n g   D O M   n o d e s . 
 
 v a r   m y N o d e s A r r a y   =   $ A . t o N o d e ( " h 2 " ,   f a l s e ,   t r u e ) ; 
 
 
 
 / /   C o n v e r t   a n   a r r a y   o f   D O M   n o d e s   i n t o   a   s i n g l e   d o c u m e n t   f r a g m e n t   e l e m e n t . 
 
 v a r   m y E l e m e n t   =   $ A . t o N o d e ( m y N o d e s A r r a y ,   t r u e ) ; 
 
 
 
 / /   O r   t h e   s a m e   u s i n g   c h a i n i n g 
 
 
 
 / /   C r e a t e   a   d o c u m e n t   f r a g m e n t   w i t h   m u l t i p l e   e l e m e n t s   a t   t h e   s a m e   l e v e l . 
 
 v a r   m y C h a i n   =   $ A ( ' < i > T h i s   i s   a   t e s t . < / i > < b r   / > < i > S o ,   t r y   t o   l o o k   i m p r e s s e d . < / i > < b r   / > < i > H e y ,   t h a t   r h y m e d ! < / i > ' ) ; 
 
 
 
 / /   R e t u r n   a n   a r r a y   o f   a l l   m a t c h i n g   D O M   n o d e s . 
 
 v a r   m y C h a i n   =   $ A ( " h 2 " ) . t o N o d e ( f a l s e ,   t r u e ) ; 
 
 
 
 / /   C o n v e r t   a n   a r r a y   o f   D O M   n o d e s   i n t o   a   s i n g l e   d o c u m e n t   f r a g m e n t   e l e m e n t . 
 
 v a r   m y C h a i n   =   $ A ( m y N o d e s A r r a y ) . t o N o d e ( t r u e ) ; 
 
 
 
 / /   T o   r e t u r n   t h e   m o d i f i e d   e l e m e n t   w i t h i n   a   c h a i n ,   u s e   t h e   " r e t u r n ( ) "   m e t h o d . 
 
 
 
 v a r   m y E l e m e n t   =   m y C h a i n . r e t u r n ( ) ; 
 
 